<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Language" content="zh-CN"><title>systemd-journal-gatewayd.service
  中文手册 [金步国]</title><style>
@font-face { font-family: "JinBuGuoWebMono"; src: url("http://www.jinbuguo.com/d/mono.ttf") format("truetype"); }
* { font-family: "JinBuGuoWebMono", "Ubuntu Mono", "Consolas", "Menlo", monospace; }
body { margin:10px; }
h1 { text-align:center; background:#ddd; }
h2#auth_name { text-align:center; margin: 10px 5%; }

    a.headerlink {
      color: #c60f0f;
      font-size: 0.8em;
      padding: 0 4px 0 4px;
      text-decoration: none;
      visibility: hidden;
    }

    a.headerlink:hover {
      background-color: #c60f0f;
      color: white;
    }

    h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
      visibility: visible;
    }
</style><script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1>systemd-journal-gatewayd.service 中文手册</h1><h2 id="auth_name">译者：<strong><a href="http://www.jinbuguo.com/">金步国</a></strong></h2><hr><h3>版权声明</h3><p>本文译者是一位开源理念的坚定支持者，所以本文虽然不是软件，但是遵照开源的精神发布。</p><ul><li>无担保：本文译者不保证译文内容准确无误，亦不承担任何由于使用此文档所导致的损失。</li><li>自由使用：任何人都可以自由的<u>阅读/链接/打印</u>此文档，无需任何附加条件。</li><li>名誉权：任何人都可以自由的<u>转载/引用/再创作</u>此文档，但必须保留译者署名并注明出处。</li></ul><h3>其他作品</h3><p>本文译者十分愿意与他人分享劳动成果，如果你对我的其他翻译作品或者技术文章有兴趣，可以在如下位置查看现有的作品集：</p><ul><li><a href="http://www.jinbuguo.com/">金步国作品集</a> [ <a href="http://www.jinbuguo.com/">http://www.jinbuguo.com/</a> ]</li></ul><h3>联系方式</h3><p>由于译者水平有限，因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好)，请来信指出，任何提高译文质量的建议我都将虚心接纳。</p><ul><li>Email(QQ)：70171448在QQ邮箱</li></ul><hr><a href="systemd.index.html">手册索引</a> ·
  <a href="systemd.directives.html">指令索引</a><span style="float:right">systemd-241</span><hr><div class="refentry"><a name="systemd-journal-gatewayd.service"></a><div class="titlepage"></div><div class="refnamediv"><h2>名称</h2><p>systemd-journal-gatewayd.service, systemd-journal-gatewayd.socket, systemd-journal-gatewayd — 专用于传输日志流的HTTP服务器</p></div><div class="refsynopsisdiv"><h2>大纲</h2><p><code class="filename">systemd-journal-gatewayd.service</code></p><p><code class="filename">systemd-journal-gatewayd.socket</code></p><div class="cmdsynopsis"><p><code class="command">/usr/lib/systemd/systemd-journal-gatewayd</code>  [OPTIONS...]</p></div></div><div class="refsect1"><a name="id-1.5"></a><h2 id="描述">描述<a class="headerlink" title="Permalink to this headline" href="systemd-journal-gatewayd.service.html#%E6%8F%8F%E8%BF%B0">¶</a></h2><p><span class="command"><strong>systemd-journal-gatewayd</strong></span> 提供通过网络传输日志流的服务。
    客户端必须使用 HTTP 协议。
    此服务默认在 19531 端口监听。
    如果使用 <code class="option">--cert=</code> 指定了服务器证书，
    那么将只接受 HTTPS 连接。</p><p>此程序由
    <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>
    调用，并且接收一个单独的套接字。可以使用
    <span class="command"><strong>systemctl start systemd-journal-gatewayd.socket</strong></span> 命令启动服务，
    可以使用 <span class="command"><strong>systemctl enable systemd-journal-gatewayd.socket</strong></span>
    命令将其设为开机自动启动。</p></div><div class="refsect1"><a name="id-1.6"></a><h2 id="选项">选项<a class="headerlink" title="Permalink to this headline" href="systemd-journal-gatewayd.service.html#%E9%80%89%E9%A1%B9">¶</a></h2><p>可接受的命令行选项如下：</p><div class="variablelist"><dl class="variablelist"><dt id="--cert="><span class="term"><code class="option">--cert=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#--cert=">¶</a></dt><dd><p>指定 PEM 格式的服务器证书文件的路径。
        使用此选项之后，
        <span class="command"><strong>systemd-journal-gatewayd</strong></span> 将会以 HTTPS 模式运行。
        此选项必须与
        <code class="option">--key=</code> 同时使用。</p></dd><dt id="--key="><span class="term"><code class="option">--key=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#--key=">¶</a></dt><dd><p>指定 PEM 格式的服务器私钥文件的路径。
        注意，此私钥必须与
         <code class="option">--cert=</code> 服务器证书互相匹配。</p></dd><dt id="--trust="><span class="term"><code class="option">--trust=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#--trust=">¶</a></dt><dd><p>指定 PEM 格式的 
        CA 证书文件的路径。</p></dd><dt id="-D DIR"><span class="term"><code class="option">-D <em class="replaceable"><code>DIR</code></em></code>, </span><span class="term"><code class="option">--directory=<em class="replaceable"><code>DIR</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#-D%20DIR">¶</a></dt><dd><p>接收一个以绝对路径表示的日志目录。
        如果设置了此选项，那么 <span class="command"><strong>systemd-journal-gatewayd</strong></span>
        将会基于此处设置的 <em class="replaceable"><code>DIR</code></em> 目录提供日志传输服务，
        而不是基于默认的日志目录(包括运行时日志目录与系统日志目录)。</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#-h">¶</a></dt><dd><p><a name="help-text"></a>显示简短的帮助信息并退出。
    </p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#--version">¶</a></dt><dd><p><a name="version-text"></a>显示简短的版本信息并退出。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.7"></a><h2 id="URL">URL<a class="headerlink" title="Permalink to this headline" href="systemd-journal-gatewayd.service.html#URL">¶</a></h2><p>可以识别的URL格式如下：</p><div class="variablelist"><dl class="variablelist"><dt id="/browse"><span class="term"><code class="uri">/browse</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#/browse">¶</a></dt><dd><p>交互式浏览</p></dd><dt id="/entries[?option1&amp;option2=value…]"><span class="term"><code class="uri">/entries[?option1&amp;option2=value…]</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#/entries%5B?option1&amp;option2=value%E2%80%A6%5D">¶</a></dt><dd><p>以各种不同的格式拉取日志事件。</p><p>HTTP 头中的 <code class="option">Accept:</code>
        用于指定格式，详见下面的"Accept 头"小节。
        </p><p>HTTP 头中的 <code class="option">Range:</code>
        用于指定日志事件的范围，
        详见下面的"Range 头"小节。
        </p><p>可以使用GET参数来控制拉取哪些日志事件。
        详见下面的"URL GET 参数"小节。</p></dd><dt id="/machine"><span class="term"><code class="uri">/machine</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#/machine">¶</a></dt><dd><p>获取一个以 JSON 格式描述的系统信息。</p><p>示例：
        </p><pre class="programlisting">{ "machine_id" : "8cf7ed9d451ea194b77a9f118f3dc446",
  "boot_id" : "3d3c9efaf556496a9b04259ee35df7f7",
  "hostname" : "fedora",
  "os_pretty_name" : "Fedora 19 (Rawhide)",
  "virtualization" : "kvm",
  …}</pre><p>
        </p></dd><dt id="/fields/FIELD_NAME"><span class="term"><code class="uri">/fields/<em class="replaceable"><code>FIELD_NAME</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#/fields/FIELD_NAME">¶</a></dt><dd><p>获取日志中 FIELD_NAME 字段的值列表</p></dd></dl></div></div><div class="refsect1"><a name="id-1.8"></a><h2 id="Accept 头">Accept 头<a class="headerlink" title="Permalink to this headline" href="systemd-journal-gatewayd.service.html#Accept%20%E5%A4%B4">¶</a></h2><p>
      <code class="option">Accept: <em class="replaceable"><code>format</code></em></code>
    </p><p>能够识别的 format 如下：</p><div class="variablelist"><dl class="variablelist"><dt id="text/plain"><span class="term"><code class="constant">text/plain</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#text/plain">¶</a></dt><dd><p>这是默认值。
        表示以纯文本输出 syslog 格式的日志，每一行就是一个日志事件。
        与 <span class="command"><strong>journalctl --output short</strong></span> 的输出格式相同。</p></dd><dt id="application/json"><span class="term"><code class="constant">application/json</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#application/json">¶</a></dt><dd><p>以 JSON 格式输出日志事件，
        每一行就是一个日志事件。
        与 <span class="command"><strong>journalctl --output json</strong></span> 的输出格式相同。
        参见 <a class="ulink" href="https://www.freedesktop.org/wiki/Software/systemd/json" target="_top">Journal
        JSON Format</a> 以了解详情。</p></dd><dt id="text/event-stream"><span class="term"><code class="constant">text/event-stream</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#text/event-stream">¶</a></dt><dd><p>以 JSON 格式输出日志事件，
        并按照 <a class="ulink" href="https://developer.mozilla.org/en-US/docs/Server-sent_events/Using_server-sent_events" target="_top">
        Server-Sent Events</a> 规范进行封装。
        与 <span class="command"><strong>journalctl --output json-sse</strong></span> 的输出格式相同。
        </p></dd><dt id="application/vnd.fdo.journal"><span class="term"><code class="constant">application/vnd.fdo.journal</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#application/vnd.fdo.journal">¶</a></dt><dd><p>将日志事件
        序列化为一个二进制流(主要内容依然是文本)，
        以便于备份和网络传输。
        与 <span class="command"><strong>journalctl --output export</strong></span> 的输出格式相同。
        参见 <a class="ulink" href="https://www.freedesktop.org/wiki/Software/systemd/export" target="_top">Journal
        Export Format</a> 以了解详情。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.9"></a><h2 id="Range 头">Range 头<a class="headerlink" title="Permalink to this headline" href="systemd-journal-gatewayd.service.html#Range%20%E5%A4%B4">¶</a></h2><p>
      <code class="option">Range: entries=<em class="replaceable"><code>cursor</code></em>[[:<em class="replaceable"><code>num_skip</code></em>]:<em class="replaceable"><code>num_entries</code></em>]</code>
    </p><p>其中，
      <code class="option">cursor</code> 是一个游标(cursor)字符串、
      <code class="option">num_skip</code> 是一个有符号整数、
      <code class="option">num_entries</code> 是一个有符号整数。
    </p><p>默认的 Range 是拉取全部日志事件。</p></div><div class="refsect1"><a name="id-1.10"></a><h2 id="URL GET 参数">URL GET 参数<a class="headerlink" title="Permalink to this headline" href="systemd-journal-gatewayd.service.html#URL%20GET%20%E5%8F%82%E6%95%B0">¶</a></h2><p>可以在URL中使用下列参数：</p><div class="variablelist"><dl class="variablelist"><dt id="follow"><span class="term"><code class="uri">follow</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#follow">¶</a></dt><dd><p>等待新的日志事件。
        与 <span class="command"><strong>journalctl --follow</strong></span> 类似，
        不同之处在于不限制返回的日志事件的数量。</p></dd><dt id="discrete"><span class="term"><code class="uri">discrete</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#discrete">¶</a></dt><dd><p>按照给定的游标(cursor)检索日志事件。
        仅返回与指定游标(cursor)匹配的那一条日志事件。</p></dd><dt id="boot"><span class="term"><code class="uri">boot</code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#boot">¶</a></dt><dd><p>仅检索系统本次启动中的日志事件。
        相当于 <span class="command"><strong>journalctl -b</strong></span> </p></dd><dt id="KEY=match"><span class="term"><code class="uri"><em class="replaceable"><code>KEY</code></em>=<em class="replaceable"><code>match</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-journal-gatewayd.service.html#KEY=match">¶</a></dt><dd><p>根据日志字段进行匹配。参见
        <a href="systemd.journal-fields.html#"><span class="citerefentry"><span class="refentrytitle">systemd.journal-fields</span>(7)</span></a> 手册。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.11"></a><h2 id="例子">例子<a class="headerlink" title="Permalink to this headline" href="systemd-journal-gatewayd.service.html#%E4%BE%8B%E5%AD%90">¶</a></h2><p>从本机日志中检索本次启动中的日志事件，
    并按照 <a class="ulink" href="https://www.freedesktop.org/wiki/Software/systemd/export" target="_top">Journal
    Export Format</a> 格式输出：
    </p><pre class="programlisting">curl --silent -H'Accept: application/vnd.fdo.journal' \
       'http://localhost:19531/entries?boot'</pre><p>
    </p><p>监听内存转储(core dump)事件：
    </p><pre class="programlisting">curl 'http://localhost:19531/entries?follow&amp;MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1'</pre></div><div class="refsect1"><a name="id-1.12"></a><h2 id="参见">参见<a class="headerlink" title="Permalink to this headline" href="systemd-journal-gatewayd.service.html#%E5%8F%82%E8%A7%81">¶</a></h2><p>
      <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
      <a href="journalctl.html#"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>,
      <a href="systemd.journal-fields.html#"><span class="citerefentry"><span class="refentrytitle">systemd.journal-fields</span>(7)</span></a>,
      <a href="systemd-journald.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-journald.service</span>(8)</span></a>,
      <a href="systemd-journal-remote.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-journal-remote.service</span>(8)</span></a>,
      <a href="systemd-journal-upload.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-journal-upload.service</span>(8)</span></a>
    </p></div></div></body></html>
